home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / Borland / Borland Pascal with Objects 7.0 / TFDOC.ZIP / HELPME!.PRF next >
Text File  |  1992-10-27  |  10KB  |  192 lines
  1.                       TURBO PROFILER TIPS AND HINTS
  2.                       =============================
  3.  
  4.   This file contains a list of the most commonly asked questions about 
  5.   Turbo Profiler. In addition, there is a section on mouse usage at the 
  6.   end of the file.
  7.  
  8. 1. Answers to common questions
  9. ==============================
  10.  
  11.   1. How can a "}" line in the program possibly use 90% of the total time
  12.      spent in the program?
  13.   
  14.      Turbo Profiler area markers only mark the beginning of an area when you
  15.      are profiling in active analysis mode. All time spent in the program
  16.      after hitting one area marker is charged to that marker until the
  17.      program hits a different area marker. Thus, if you're profiling one
  18.      routine in your program with an area set on each line in the routine,
  19.      you should see normal results for all lines except the last one. The
  20.      last line (usually an "end.") will show all the time spent between 
  21.      calls to the routine.
  22.     
  23.      Several methods can be used to obtain normal-looking results. You can
  24.      use the Filter/Current local command in the Execution Profile window to
  25.      remove that line from the statistics after each run. Or you can set
  26.      that area to Disable statistics collection, using the Operation command
  27.      in the Module or Areas windows. (Set the first area in the routine to
  28.      Enable statistics collection or you will only get results from the first
  29.      call to the routine.) Or you can switch to passive analysis mode, which
  30.      uses the area markers in a completely different way.
  31.     
  32.   2. What's the difference between Active and Passive analysis?
  33.     
  34.      Think of it this way: while profiling, your program is like a rabbit
  35.      running through a maze. The maze is set up with buttons (area markers)
  36.      on the floor. In active analysis mode, each button the rabbit hits
  37.      tells Turbo Profiler the part of the maze the rabbit is going into. In
  38.      passive analysis mode, each button marks the boundary between two areas,
  39.      and when a flash of light goes off, Turbo Profiler records which two
  40.      buttons the rabbit is between.
  41.   
  42.   3. How does Turbo Profiler handle screen output for graphics- and 
  43.      text-based programs?
  44.   
  45.      There are a number of strategies that can be used to control how and
  46.      when the screen gets refreshed. If you are profiling a program that
  47.      uses a graphics display mode or are using a Borland pop-up utility
  48.      (such as SideKick or SideKick Plus) while profiling, you should review
  49.      the following tips.
  50.      
  51.      The default screen-updating mode is "Swap"; this means that Turbo
  52.      Profiler uses a single display adapter and display page, and swaps the
  53.      contents of the User and Turbo Profiler screens in software. This is
  54.      the slowest method of display swapping, but it is the most protective
  55.      and least disruptive.
  56.      
  57.      Pop-up utilities may not appear on the screen if your screen updating
  58.      is set to Flip, even though they are active and processing your
  59.      keystrokes. You must select "Swap" mode for display updating in order
  60.      for these programs to work properly. Use Turbo Profiler's -ds
  61.      command-line option to do this, or use the TFINST utility to
  62.      permanently set this mode. Swap mode makes screen updating slower, but
  63.      it makes sure that Turbo Profiler's screen does not interfere with
  64.      either your program's or any other program's display.
  65.     
  66.      You may also need to use "Swap" when you use the DOS Shell command or
  67.      run an editor from within Turbo Profiler. Most programs expect to run 
  68.      on video page 0, and don't check to see what the current video page is.
  69.      Turbo Profiler's DOS Shell and any editors that Turbo Profiler runs 
  70.      in "Flip" mode don't run from video page 0, and the programs might 
  71.      appear to hang, even though you'll be able to type in keystrokes normally.
  72.      If this happens, use the -ds command-line option when you run Turbo 
  73.      Profiler, or reinstall Turbo Profiler to use "Swap" instead of "Flip."
  74.     
  75.      If you're profiling a graphics mode application, you must specify the
  76.      -ds command-line option ("Swap" contents). You might also want to use
  77.      Turbo Profiler's -vg command-line option (Graphics Save), which causes
  78.      additional memory to be set aside for saving the entire graphics image
  79.      your program produces. If you don't use this option, a "red cloud" 
  80.      might appear on your program's screen. You can also set the -ds and -vg 
  81.      options permanently with the TFINST program. The Graphics Save option
  82.      takes an additional 8K of memory and slows screen-swapping.
  83.     
  84.      If you're running a graphics program that changes the EGA palette,
  85.      make sure you use the -vp command-line option to save the palette.
  86.   
  87.   4. Can Turbo Profiler execute other programs while you're still profiling?
  88.      
  89.      When you're using Turbo Profiler, the DOS Shell and Edit commands in the 
  90.      Module and File windows can swap the program you're profiling to disk 
  91.      to make room for running DOS or your editor. The default amount of memory 
  92.      to swap is 128K. You can use TFINST to set a different amount if that's 
  93.      not enough memory to run your editor or other programs. Setting the swap 
  94.      size to 0K tells Turbo Profiler to swap the entire user program to disk 
  95.      before running the DOS command processor.
  96.  
  97.      Only your program gets swapped to disk; Turbo Profiler remains in
  98.      memory.
  99.  
  100.   5. Why can't I press Ctrl-Break to get out of a program running on a
  101.      remote machine?
  102.  
  103.      The program running on the remote machine has taken control of
  104.      Interrupt 1B (Ctrl-Break). TFREMOTE does not take back control of
  105.      Interrupt 1B until you stop execution of the running program on the
  106.      profiler side by completing the program or pressing Ctrl-F2 (Program
  107.      Reset).
  108.     
  109.   6. What is the most likely reason for Turbo Profiler to hang when
  110.      starting up on a PC-compatible computer?
  111.      
  112.      If your computer is a Tandy 1000, IBM PC Convertible, or NEC
  113.      MultiSpeed, or if Turbo Profiler hangs when loading onto your system, 
  114.      run TFINST and change an item in the Options\Miscellaneous menu so that
  115.      NMI Intercept is not set. Some computers use the NMI (Non-Maskable
  116.      Interrupt) in ways that conflict with Turbo Profiler, so you must disable
  117.      Turbo Profiler's use of this interrupt in order to run the program.
  118.      
  119.      Also, if you're using a machine based on the Intel 80386 processor (or
  120.      higher) and you have the SuperKey utility loaded, be careful not to 
  121.      press a key when TF386 is loading, since SuperKey might capture the 
  122.      keystroke and cause unexpected results.
  123.   
  124.   
  125. 2. Mouse support
  126. ================
  127.   Turbo Profiler provides mouse support that allows you to manipulate 
  128.   elements of the user interface. Most Turbo Profiler mouse operations are 
  129.   similar to Windows mouse operations. In the material that follows, we 
  130.   discuss some driver issues, some uses of the mouse under Turbo 
  131.   Profiler that are different from standard Windows mouse usage, and
  132.   some problems you might encounter with using a mouse with TPROFW.
  133.  
  134.  
  135. Mouse drivers
  136. -------------
  137.   If you have a mouse driver installed by default, Turbo Profiler
  138.   and installation utilities will try to use your mouse. If you don't
  139.   want to use your mouse during a debugging session, you can use the
  140.   command-line switch '-p-' to turn the mouse off. You can also set
  141.   this option in TFINST.
  142.  
  143.   Your mouse driver is the application that you install to make your
  144.   mouse active inside Turbo Profiler and other programs. Most mouse
  145.   drivers will work with Turbo Profiler but may have to be updated
  146.   to a newer version if you are having problems using an older
  147.   version.
  148.  
  149.   If you have problems with the mouse once you have loaded Turbo 
  150.   Profiler or TFINST, you might try using the Display Swap option 
  151.   that can be specified either in TFINST or on the command-line with 
  152.   the -ds switch. Consult your mouse manual to ensure proper use of the
  153.   mouse and its driver. Early versions of mouse drivers don't
  154.   support screen display modes larger than 80 columns by 24 lines.
  155.   As a result, your mouse driver might not work correctly when you
  156.   use Turbo Profiler's EGA 80x43, VGA 80x50, or EGA/VGA graphics modes.
  157.  
  158.  
  159. Using the mouse
  160. ---------------
  161.   Most mice provide two or three buttons that allow for various
  162.   functions inside an application. With Turbo Profiler you can, among 
  163.   other things, use the left mouse button to select options, move items 
  164.   around on the screen, and set breakpoints. 
  165.  
  166.   Double-clicking the mouse on an item in a list chooses the item. 
  167.   For instance, in the File|Open dialog box clicking the mouse once 
  168.   just highlights a file. Double-clicking loads the file.
  169.  
  170.   The right mouse button, while it has some of the same functionality 
  171.   as the left mouse button, can also open local menus within Turbo 
  172.   Profiler windows. 
  173.  
  174.   You can also choose the commands shown at the bottom of the screen, 
  175.   like F1-Help, by using the mouse.
  176.  
  177.  
  178. Mouse problems when profiling Windows programs
  179. ----------------------------------------------
  180.   When the mouse driver is disabled for Windows, it will be disabled
  181.   for TPROFW as well.  Starting TRPOFW with the mouse support option
  182.   (-p) has no effect unless you enable the Windows mouse driver.
  183.   
  184.   If you have a mouse driver installed by default, TPROFW and the
  185.   installation utilities will try to use your mouse. If you 
  186.   don't want to use your mouse during a debugging session, you 
  187.   can use the command-line switch '-p-' to turn the mouse off. 
  188.  
  189.   When you're debugging a Windows application that uses the mouse,
  190.   and you reset the application and then run the program, it won't
  191.   accept mouse clicks until you make a keyboard entry.
  192.